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1  INTRODUCTION 

In  the  last  few  years,  ROSCOE  (Radar  and  Optical  Systems  Code  with 
Nuclear  Effects)  has  been  expanded  to  include  simulations  of  satellite 
communications  and  optical  surveillance  systems  in  a  nuclear  environment. 
This  expansion  has  led  to  considerably  more  complexity  in  the  input  re¬ 
quirements  . 

While  the  ROSCOE  input  scheme  was  devised  to  handle  these  problems 
(with  no  additional  coding)  and  to  allow  the  user  complete  flexibility 
in  structuring  scenarios  with  multiple  sensors,  objects,  and  bursts,  it 
takes  some  time  to  learn  how  to  use  the  system.  For  the  user  who  only 
occasionally  runs  the  code,  or  would  like  to  run  a  small  problem,  a  new 
input  scheme  has  been  built  for  running  a  subset  of  ROSCOE  problems  with 
a  simple  set  of  inputs. 

The  next  section  describes  this  new  input  scheme.  Example  input 
sets  are  shown  for  several  different  types  of  problems  and  the  program 
outputs  are  briefly  discussed.  Section  3  describes  how  to  access  the 
new  scheme,  for  both  batch  and  interactive  jobs.  Finally,  to  make  this 
paper  useful  as  a  reference  guide,  tables  which  describe  the  input  options 
have  been  placed  in  Appendix  A. 


2  DESCRIPTION 

The  new  ROSCOE  input  scheme  consists  of  a  data  deck  with  a  pre¬ 
selected  set  of  input  options,  and  a  data  preprocessor  program  which 
inserts  user-specified  values  for  the  options  into  the  data  deck.  The 
scheme,  in  general,  does  not  sacrifice  any  of  ROSCOE 's  input  versatility 
since  a  new  data  deck  with  a  different  set  of  options  can  be  generated 
without  writing  new  code. 

2.1  LIMITATIONS 

With  the  new  scheme,  as  currently  set  up,  the  user  can  run  nuclear 
burst  phenomenology  problems  alone,  or  nuclear  effects  on  radar  sur¬ 
veillance  and  tracking  of  ballistic  missiles,  satellite  communication, 
or  optical  surveillance  and  tracking,  subject  to  these  constraints: 

•  Up  to  five  bursts  are  allowed,  at  altitudes  up  to  400  km  — 
positions,  times,  and  burst  properties  are  input. 

•  Only  one  radar  can  be  simulated  in  a  run  —  radar  character¬ 
istics  and  location  are  input. 

•  Only  one  object  trajectory  can  be  simulated  in  a  run 
(although  multiple  objects  can  be  spaced  in  time  on  the  tra¬ 
jectory) — launch  and  impact  points,  impact  time,  and 
reentry  angle  are  input. 

•  Only  one  satellite  communication  system  can  be  simulated  in 
a  run  (consisting  of  one  ground  transmitter,  one  ground 
receiver,  and  one  set  of  satellite-borne  equipment  which 
receives  and  transmits)  —  transmitter  and  receiver  charac¬ 
teristics  and  locations  are  input. 

•  Only  one  optical  sensor  can  be  simulated  in  a  run  —  sensor 
characteristics  and  location  are  input. 


Run  times  can  be  no  more  than  900  seconds  after  the  last 


2.2  INPUT  VARIABLES 


Input  variables  in  the  new  scheme  are  of  five  types: 

•  General  Inputs.  Variables  related  to  a  reference  location 
or  time. 

•  Physics  Inputs.  Variables  required  to  simulate  a  burst  and 
print  physics  outputs. 

•  Radar  Inputs.  Variables  required  to  simulate  radar  surveil¬ 
lance  or  tracking  performance. 

•  Satcom  Inputs.  Variables  required  to  simulate  a  satellite 
communication  problem. 

•  Optics  Inputs.  Variables  required  to  simulate  optical  sensor 
surveillance  or  tracking  performance. 

Table  A.l  is  a  directory  of  input  variables,  divided  into  the  five  types 
described  above  with  notes  to  indicate  the  options  available.  For  each 
variable,  the  table  gives  its  name,  the  number  of  values  to  be  supplied 
(more  than  one  if  the  variable  is  a  vector),  a  definition  of  the  variable 
including  default  units  of  measure,  the  default  values  that  will  be 
assumed  if  you  do  not  input  the  variable,  and  whether  a  unit  name  is 
allowed  for  the  variable.  (Table  A. 2  shows  the  allowable  unit  names.) 

It  is  important  to  note  the  default  units  given.  If  you  input  values 
without  unit  names  (for  those  variables  allowing  unit  names),  the  de¬ 
fault  units  are  assumed.  Note  that  the  default  values  listed  in  Table 
A. 2  are  given  in  their  customary  units,  which  are  not  always  the  same 
as  tlie  internal  default  units. 

To  run  a  case,  follow  the  instructions  given  in  Table  A.l,  and  input 
those  variables  you  wish  to  change  in  the  form:  variable  =  value  unit, 
variable  =  value  unit,  etc.  End  the  input  string  with  the  command  RUN 
following  the  last  variable  input.  For  vectors,  the  format  may  be: 
vector  =  value  unit,  value  unit,  etc.,  or  vector (index)  =  value  unit, 
value  unit,  etc.  In  the  first  case,  the  values  are  assigned  to  vector(l). 
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vector(2),  etc,;  in  the  second  case,  values  are  assigned  to  vector (index) , 
vector(index  +  1),  etc.  This  free  format  is  essentially  compatible  with 
the  Fortran  NAMELIST  input  scheme. 

Note  that  positions  can  be  specified  by  geographical  coordinates 
(GEOGR) ,  or  by  Cartesian  (LOCXYZ)  or  range-azimuth-elevation  (RADAR) 
coordinates  relative  to  a  reference  location.  The  order  of  entry, 
orientation,  and  units  for  these  specifications  are  given  in  Table  A. 3 
and  Fig.  A.l. 

2.3  EXAMPLE  INPUT  SETS 

2.3.1  Physics  Problem 

To  run  a  simple  physics  problem  consisting  of  a  single  burst  with 
the  default  characteristics  and  these  assumptions: 

•  Burst  time  =  0  s 

•  Yield  =  10  kT 

•  Altitude  =  40  km 

•  Output  every  20  s  until  120  s  after  burst 
input : 

TST0P  =  120,  0TIME  =  0,  0TINT  =  20,  BTIME1  =  0, 

BP0S1(3)  =  40,  YIELD l  =  10  KT,  RUN 

2.3.2  Radar  Problem 

To  run  a  radar  surveillance  problem,  where: 

•  There  is  a  single  burst  with  the  above  properties. 

•  The  radar  is  at  the  center  of  a  local  Cartesian  coordinate 
system  (directly  under  the  burst). 

•  The  radar  is  of  the  type  described  by  the  default  parameters. 

•  The  object  being  viewed  has  a  -30°  reentry  angle  and  is  aimed 
at  the  radar. 


A 


•  The  object  is  at  100  km  altitude  at  time  =  0  when  the 
burst  occurs. 

•  Radar  measurements  are  made  once  every  second  for  20  s. 

input : 

TST0P  =  20,  BTIME1  =  0,  BP0S1(3)  =  40,  VIELD1  =  10  KT, 
0BTAC  =  0BJECT-1,  0BTIM  =  0,  0BP0S(2)  =  173, 

100  KM,  0BVEL(3)  =  -30,  RADAR  =  REFER,  RUN 

2.3.3  Satcom  Problem 

To  run  a  satellite  communication  problem,  where: 

•  The  ground  transmitter  and  receiver  are  together,  directly 
beneath  a  satellite  at  synchronous  altitude  (the  default 
condition) 

•  The  default  link  inputs  are  assumed 

•  The  default  nuclear  burst  (1  MT  at  200  km  altitude)  occurs 
10  s  after  the  first  communication 

•  The  burst  is  displaced  200  km  horizontally  from  the 
line  of  sight 

•  Communication  calculations  are  made  every  20  s,  from 
0  s  to  100  s 

input : 

TST0P  =  100,  BTIME1  =  10,  BP0S1(2)  =  200,  CTIME  =  0, 

CTINT  =  20,  RUN 

2.3.4  Optics  Problem 

To  run  an  optical  sensor  surveillance  problem,  where: 

•  There  is  a  single  burst  of  10  kt  at  40  km  altitude 

•  The  sensor  is  at  synchronous  altitude 

•  Thu  sensor  is  pointed  at  the  burst 
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•  The  sensor  is  of  the  type  described  by  the  default  parameters 

•  Sensor  calculations  are  made  at  only  one  time  (0  s) 

input : 

TST0P  =  1,  BTIME1  =  0,  BP0S1(3)  =  40,  YIELD1  =  10  KT, 

0BTAG  =  REF-0BJECT,  0TYPE  =  SURVEILLANCE,  0L00K  =  0, 

REFPT(l)  =  40,  0PTICS  =  REFER,  RUN 

2 . 4  OUTPUTS 

The  outputs  produced  by  the  ROSCOE  code  using  the  new  input  scheme 
are  described  in  this  section.  Two  types  of  outputs  may  be  produced: 

(1)  printer  plots,  and  (2)  tabular  outputs. 

2.4.1  Printer  Plots 

When  a  high-altitude  (>90  km)  burst  is  simulated,  the  code  pro¬ 
duces  a  series  of  printer  plots  at  times  specified  by  the  0TIME,  0TINT 
input  variables.  The  plots  consist  of  a  picture  of  the  fireball  and 
beta  tube  region  and  contour  plots  of  mass  density,  electron  density, 
and  striation  fraction  in  the  high-altitude  grid. 

The  contour  plots  of  mass  density  and  electron  density  represent 
vertical  cross  sections  through  the  burst  point  in  the  (magnetic)  north- 
south  direction,  viewed  looking  eastward.  The  contour  plots  of  the 
striation  fraction  are  cross  sections  normal  to  the  earth's  magnetic 
field,  viewed  looking  down  the  field  lines. 

The  plots  are  produced  as  they  are  computed  internally,  and  thus 
will  appear  before  the  tabular  output  described  below. 

In  addition,  contour  plots  of  the  relative  radiance  at  the  focal 
plane  of  the  sensor  can  be  generated  when  the  optics  code  is  used.  These 
plots  are  generated  when  the  optics  calculation  type,  OCAi  ,  is  set  to  FOV. 
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2.4.2  Tabular  Outputs 

There  are  seven  phenomenology  lists,  five  radar  lists,  two 
satellite-communication  lists,  and  three  optics  lists  that  may  be  output 
at  the  conclusion  of  the  run,  depending  on  the  type  of  simulation  per¬ 
formed  . 

The  phenomenology  lists  include:  burst  parameters,  common  fire¬ 
ball  parameters  (fireball  set  1),  two  additional  low-altitude  fireball 
parameter  lists  (fireball  set  2  and  fireball  set  3),  additional  high- 
altitude  fireball  parameters  (fireball  set  4),  contained  debris  region 
parameters,  and  beta  tube  parameters. 

The  radar  lists  include:  trajectory  output,  track  measurement 
errors,  track  filter  output,  and  two  lists  of  propagation  errors. 

The  satcom  lists  include:  propagation  and  probabili ty-of-error 
data,  and  satellite  position  coordinates  with  respect  to  the  ground- 
terminal  positions. 

The  optics  output  lists  include:  angle  and  signal-strength  measure¬ 
ments  for  an  optical  tracking  sensor  application,  the  radiance  along  each 
path  treated  within  the  f ield-of-view,  and  the  data  stream  output  pro¬ 
duced  by  a  scanning  sensor. 

Table  1  shows  a  small  sample  of  each  type  of  output.  Some  of 
the  column  headings  are  self-explanatory,  while  others  require  additional 
comment . 
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NOTE:  The  last  four  columns  show  the  scanned  signal  output  (irradiance  at  the  detector),  the  normalized  signal  output  (the  irradlance 
normalized  to  the  sensor  NEFD1 .  the  final  signal  output  (after  all  other  processing  such  as  differencing  has  been  completed),  and  the 
target  detection  flag  which  signifies  whether  the  final  signal  exceeds  a  preset  threshold  designating  the  point  a  "TARGET”  versus  a 
"BKGND"  point. 
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ACCESSING  THE  INPUT  SCHEME 


3.1  BATCH  JOBS 

To  access  and  use  the  new  input  scheme  in  the  batch  mode  (i.e., 
by  submitting  a  card  input  deck  over  the  counter  or  through  a  remote 
terminal),  use  a  deck  setup  such  as  that  shown  in  Table  A. 4. 

Note  that  an  optional  card  may  precede  the  data  cards,  directing 
the  input  program  to  print  each  default  card  changed,  followed  by  the 
new  card  which  replaces  it. 

3.2  INTERACTIVE  JOBS 

To  access  and  use  the  new  input  scheme  using  the  time-share 
system  follow  these  steps  (also  shown  in  Table  A. 6).  (First,  you  must 
have  a  procedure  permfile  containing  a  small  CYBER  control  language 
"PR0C"  and  a  set  of  control  cards.  A  sample  procedure  permfile  is  shown 
in  Table  A. 5) 

Step  1.  Access  your  procedure  file  with  the  ATTACH  statement. 

Step  2.  Execute  the  ROS<"OE  time-share  program  by  typing  R0SC0TS. 

Step  3.  Type  your  inputs,  in  response  to  the  program's 

message  "INPUTS?".  The  program  then  processes  the 
inputs;  that  is,  inserts  them  into  the  standard  deck 
and  checks  for  errors.  If  errors  occur,  the  program 
prints  them  and  asks  you  to  input  a  revised  list  by 
again  asking  "INPUTS?".  When  no  errors  occur,  termi¬ 
nate  R0SC0TS  by  typing  "RUN".  The  job  file  is  then 
automatically  placed  in  the  input  queue,  and  control 
returns  to  the  INTERCOM  system.  You  can  check  that 
your  job  has  been  accepted  by  typing  a  FIND,  nnn 
command,  where  nnn  is  the  first  1-3  characters  of  the 
job  name  (first  parameter  on  your  first  control  card). 
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TABLE  A.  2 


Category 

F  requency 

i'ime 

Mass 

Ballistic  Coeff. 

Length 


Acce 1 oration 
Area 


ALLOWABLE  UNIT  NAMES 


Unit  Name 


Scaling  Factor  to  Internal 
( Default)  Units _ 


MUZ  1,000,000 

KHZ  1,000 


HRS 

SEC 


1  (This  may  only  be  used 
for  time-of-day  inputs) 

1 


KC 


CM 

LB 


1  ,000 

1 

453.592 


PSF  0.4882405 

CM/CMSQ  1 


CM 

FT 

KM 

NMI  or  NM 
M 

KFT 


1 

30.48 

100,000 

185,325 

100 

30,480 


C. 


980.665 


CMSQ 

MSQ 

INSO 

FTSQ 


1 

10,000 

6.4516 

929.0304 
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TABLE  A. 2  (Cont'd.) 

ALLOWABLE  UNIT  NAMES 


Scaling  Factor  to  Internal 


Category 

Unit  Name 

(Default)  Units 

Yield 

MT 

1 

KT 

0.001 

Radar  Range/Standard 

CMSQCM 

1 

Target 

KM  SQM 

10,000 

NMSQM 

18532.5 

KFSQM 

3048 

Powe  r 

WATTS 

10,000,000 

Power  Ratio 

DB 

X  dB->10X/1° 

Angle 

DEC 

0.01743329252 

RAD 

1 

MRAD 

0.001 
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TABLE  A. 3 


GEOGR 


LOCXYZ 


RADAR 


POSITION  COORDINATE  SPECIFICATIONS 


Geographical  Coordinates: 

•  Altitude  (KM) 

•  East  longitude  (DEG)  (longitudes  west  of  Greenwich 
input  as  negative) 

•  North  latitude  (DEG)  (south  latitudes  negative) 

Local  Tangent  Plane  Coordinates  (see  Fig.  A.l): 

•  Geographic  east  (KM)  (west  input  as  negative) 

•  Geographic  north  (KM)  (south  input  as  negative) 

•  Distance  above  plane  (KM) 

Local  Radar  Coordinates  (see  Fig.  A.l); 

•  Slant  range  (KM) 

•  Azimuth  (DEG)  (positive  CCW  from  east) 

•  Elevation  (DEG)  (positive  above  horizontal) 


AiV-S7  7S£ 


TABLE  A. A 


SAMPLE  CONTROL  CARD  DECK  FOR  AFWL/NOS/BE1 


JQ3  c  a i . . . 

A  C  UQUr  |  f  C  A P L  •  •  •  •  • 

'■AA^I  jFT  ) 

A  T  T  A  C  M  (  X  >  1  *OtHi'iAKY  «  IC  =  ut<CXJuu  »CY  =  1  ) 

COpYuH  (x>.1 ,0tUf\j,^H0) 

ATTACin  xx^  «  CBII'gAK  r  .  IC  =  GKCXoJ8  «C  Y=«; ) 

CjPYLr  (  Xxii , 

•<LTul<h<xxi,xx;2) 

RLWlMD  (  C,i  ifj  > 

ATTACH  (  n,C  I’YL  .  uLP  YLHGSCCL  .  I IJ  =  u»<  C  X  JOh  .  C.  Y  =  6  ) 

A  T  T  mC  1 1  (  S  r  R  U  C  Y  *  •  j  S  I  R  U  C  T  ,  iJ  =  G^lXwv-B  ) 

JpDaT[  ((-'sSTkUCI  »F»U»d«C  =  TAPLl«L  =  l) 
3cpYL(TAvCl»CcIN»LT  ILt.  »»»KLALi»RLwIul.  *F«f<U«S  ) 
^ETuhru  TAHU,  1  APc4«HCLTu,0H1|\i) 

A  T  t  A  l  h  (  S I  ’  i  N  L  tSPliXCRGSCuL  «  Ii;  =  CH  CXudC  »  l  y  = «? «  K  R  =  1  ) 

'  '  T  '•  *-  ‘  1  1  I  Aw  •  ~  >  1  »  i  •.  ->  J  c  •  T  >  .  C  Y  =  t  ) 

**  -1  t  l  .1  (  1  «  I  i  I  ,4  T  t  >  t  4  ■  «  I  v_  (  t  i»  t.  A  Jl  >  .  L.  ) 

ATTALH(i\lIbL«i<LIl3LROSCcL*lL  =  GKLXJJi;) 

<E;tii!s,;(  TAHL1,  TMpEi:  ,TAPLA,TAPt.4,T«PLb,  TAPLb  ) 
ATTACtM  Afv’ALGM8,  AXALGf'O^CSCOL  ,  U  =GRCXjjtj  ) 
A'Hu.i'ie. 

<rToM:  l  A *•  ALGMd  ) 

LDSt  T  (Lr..=RLl8L,PHtStT  =  ^ErtQ,PiLLS  =  TApt  1) 

CC'Abar  lit) 

MO&O. 

Rf  TuKij  (  lt  III  ) 

RE  tUK’i <  Rl  IGL  ) 

ATtAU((TAI!L3»ALWCATKCSCoE  •  IU  =  cRCXdjb) 

sr^sm. 

7-6-9  calc 

*  I  Dt  ..tT  DC  HO 
♦COM  ILL  STrtUCl 

A'JT  vouc  TO  OSTRLCT  F 1 L  L  GO  hLRt . 

7-6-9  C  C.i.O 

C-|A|j(,f  LIST  CN  . (OPTIONAL) 

SPlf.iL  u  A  7  A  inputs . 

•  •  •  >  • 

•  •  •  ■  • 

R  ,|M 

7-6-9  CALC 
6- 7-6  — 9  C  A K L 
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TABLE  A. 5 


SAMPLE  PROCEDURE  PERMFILE  FOR  INTERACTIVE  USE 


.  o*UC  ,i<QSCOTS 
C  j  P  Y  L  i ;  ( l<  i  S C  C  T  6  ,  L  A  T  C  H< «  i  ) 

M  *AC.t(  INl  «*»•  I^f<OSLCt  •  ID  =  GKCXJJ«j»Cr  =  2«^Ksl  ) 
ATTACPUM  A,i.L«U  lLHCSCOt.  lO  =  feHCXoJo#Cr  =  b) 

SP  I  l  iL  • 

3 i  Ti_l\i  j  (  St-  iNt  *  I f\, T  At-  i  XAF  i L  ) 

/  A  P  (  L'  A  1  f.  I  «»**»♦  I K  | 

C’jviM  !>n .  riLt  mavs  blli  catchlu  to  ii-pui. 

7  -  8  «.  b  C  A I  0 

J3J  L A i < f •  •  •  •  • 

ACCOUNT  C  .  Af<t  •  .  .  .  . 

I OF  f  ) 

A  [  TaC-M  Xxl  .CbiUAHY  .  I  C  =  U»<CX  J  JB  .  C  T  =  1  ) 

CoPySR (  Xa1«Ci;1,4»<i+uJ 

attach*  , >2, ;l-;i\akt  .  ILsl-tcxJvU ,ly=<! > 

CjPyhf  ( yx^.c^it.) 

•<LTcn.  J  (  XX  1  .XX/:) 
a  1 ! /U  (  CL  IN  ) 

A  TTAC.MUCPYL  .Ut-PYLKOSCCt  ,  iCsGNLXJJ8.CY  =  .i  > 

A  TtACH ( STRUCT ,Ub I KUCT  , 1U=GRCXWWB  ) 

J  P  J  a  1  £  *  r-ST  <UCT  .T  «H  If  U  =  TAHt:i  ,L  =  1  ) 

^C^Yl  <  T  Af'Ll  ,0c  iM.Lf  ILL  ,  .  .KEAL1  .rtC#*lNL),t.HHCKS  ) 
■<£  Tu*'.Ml  T  AHEl  .  I  API.  A  .liCPYL  .OBll\  I 
CoPyCK  (  If  PUT  ,  I ijC A T  A  ) 

RLaINLM  IP  DAT  A) 

ATtACH(  lit  I  BE  *i;l  IULhOSCcl  ,  IC=GhCXJJU  » 

<r  TUKf|(  T  APC1  ♦  T  APL^  .  TAP,  C,  TAPIH  ,  T  APL5,  TAPLo  > 
ATtAUi  l  A  I-  ACG^d.  AKALCf'tjUUSCCL  ,  1  [,  =  GKC X  Jjii ) 

A  v|Al  GM{) . 

<EtUKH  (  ANAlGMO  ) 

L1SL 1  <L  I  :=RLldE,PKtSE  T  =  L t He  * F i L E S  =  T Apt  1  ) 

L  J  A  i )  (  L  ►  I L  E  ) 

M  0  ”» u  • 

U  TijKi'j  (  L(  ILL  J 
T (  Rl  I ot.  ) 

Attach  <  TAPt.  j  ,HL  j*l.ATKCSCUL  .  It>  =  GKCXJuti ) 

7-H-S  C  A i . L' 

♦iOcliT  iCI'G 
•  cofc-rict  struct 

A  jT  r.,o»s  TO  OGIHCCT  FILL  GO  HLRE . 

7  »  A  »  y  c  A  R  0 
b- 7 - n- s  CARC 
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TABLE  A. 6 


TIME-SHARE  INPUTS 

(Underlined  portions  typed  by  User) 


1. 

COMMAND  - 

ATTACH  (ROSCOTS,  ID  =  GRCXJJB) 

2. 

COMMAND  - 

R0SC0TS 

3. 

INPUTS? 

(USER  TYPES  IN  INPUTS) 

INPUTS? 

(USER  TYPES  IN  INPUTS) 

ERRORS 

(  —  IF  THERE  ARE  INPUT  ERRORS,  R0SC0TS  LISTS 

• 

THEM  HERE  AND  REQUESTS  INPUTS  AGAIN) 

INPUTS? 

RUN 
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